home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / rm.z / rm
Encoding:
Text File  |  2002-10-03  |  6.5 KB  |  132 lines
  1.  
  2.  
  3.  
  4. rrrrmmmm((((1111))))                                                                    rrrrmmmm((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _rrrr_mmmm, _rrrr_mmmm_dddd_iiii_rrrr - remove files or directories
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _rrrr_mmmm [_----_ffff] [_----_iiii] _f_i_l_e ...
  13.      _rrrr_mmmm _----_rrrr [_----_ffff] [_----_iiii] _dddd_iiii_rrrr_nnnn_aaaa_mmmm_eeee . . . [_f_i_l_e . . .]
  14.  
  15.      _rrrr_mmmm_dddd_iiii_rrrr [_----_pppp] [_----_ssss] _dddd_iiii_rrrr_nnnn_aaaa_mmmm_eeee . . .
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _rrrr_mmmm removes the entries for one or more files from a directory. It does
  19.      not remove .. and anything above target directory when invoked with an
  20.      argument which ends in /..  It will print error messages in these cases.
  21.      If the directory containing the file to be removed has the 'sticky' bit
  22.      set (see _c_h_m_o_d(_2)) then in order to remove the file one of the following
  23.      must be true:
  24.  
  25.           the user owns the file,
  26.           the user owns the directory, or
  27.           the user is the super-user.
  28.  
  29.      If the kernel tunable xpg4_sticky_bit is set to 0 the file will also be
  30.      removable if it is writable by the user.
  31.  
  32.      If a file has no write permission and the standard input is a terminal,
  33.      the full set of permissions (in octal) for the file are printed followed
  34.      by a question mark.  This is a prompt for confirmation.  If the answer
  35.      begins with _yyyy (for yes), the file is deleted, otherwise the file remains.
  36.  
  37.      If _f_i_l_e is a symbolic link, the link will be removed, but the file or
  38.      directory to which it refers will not be deleted.  A user does not need
  39.      write permission on a symbolic link to remove it, provided they have
  40.      write permissions in the directory.
  41.  
  42.      Note that if the standard input is not a terminal, the command will
  43.      operate as if the _----_ffff option is in effect.
  44.  
  45.      Four options apply to _rrrr_mmmm:
  46.  
  47.      _----_ffff   This option causes the removal of all files (whether write-protected
  48.           or not) in a directory without prompting the user.  In a write-
  49.           protected directory, however, files are never removed (whatever
  50.           their permissions are), but no messages are displayed.  If the
  51.           removal of a write-protected directory is attempted, this option
  52.           will not suppress an error message.  Any previous occurrences of the
  53.           _----_iiii will be ignored.
  54.  
  55.      _----_rrrr   This option causes the recursive removal of any directories and
  56.           subdirectories in the argument list.  The directory will be emptied
  57.           of files and removed.  Note that the user is normally prompted for
  58.           removal of any write-protected files which the directory contains.
  59.           The write-protected files are removed without prompting, however, if
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrrmmmm((((1111))))                                                                    rrrrmmmm((((1111))))
  71.  
  72.  
  73.  
  74.           the _----_ffff option is used, or if the standard input is not a terminal
  75.           and the _----_iiii option is not used.
  76.           Symbolic links that are encountered with this option will not be
  77.           traversed.
  78.           If the removal of a non-empty, write-protected directory is
  79.           attempted, the command will always fail (even if the _----_ffff option is
  80.           used), resulting in an error message.
  81.  
  82.      _----_RRRR   Same as _----_rrrr
  83.  
  84.      _----_iiii   With this option, confirmation of removal of any file occurs
  85.           interactively.  Any previous occurrences of the _----_ffff option will be
  86.           ignored.
  87.  
  88.      Two options apply to _rrrr_mmmm_dddd_iiii_rrrr:
  89.  
  90.      _----_pppp   This option allows users to remove the directory _d_i_r_n_a_m_e and its
  91.           parent directories which become empty.  A message is printed on
  92.           standard output about whether the whole path is removed or part of
  93.           the path remains for some reason.
  94.  
  95.      _----_ssss   This option is used to suppress the message printed on standard
  96.           error when _----_pppp is in effect.
  97.  
  98. FFFFIIIILLLLEEEESSSS
  99.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_uuuu_xxxx_cccc_oooo_rrrr_eeee_...._aaaa_bbbb_iiii
  100.           language-specific message file [See _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn (5).]
  101.  
  102. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  103.      _uuuu_nnnn_llll_iiii_nnnn_kkkk(2), _rrrr_mmmm_dddd_iiii_rrrr(2)
  104.  
  105. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  106.      All messages are generally self-explanatory.
  107.  
  108.      It is forbidden to remove the files "_...." and "_...._...."  in order to avoid the
  109.      consequences of inadvertently doing something like the following:
  110.           _rrrr_mmmm _----_rrrr _...._****
  111.  
  112.      Both _rrrr_mmmm and _rrrr_mmmm_dddd_iiii_rrrr return exit codes of 0 if all the specified directories
  113.      are removed successfully.  Otherwise, they return a non-zero exit code.
  114.  
  115. NNNNOOOOTTTTEEEESSSS
  116.      A _----_---- permits the user to mark explicitly the end of any command line
  117.      options, allowing _rrrr_mmmm to recognize filename arguments that begin with a _----.
  118.      As an aid to BSD migration, _rrrr_mmmm will accept _---- as a synonym for _----_----.  This
  119.      migration aid may disappear in a future release.  If a _----_---- and a _---- both
  120.      appear on the same command line, the second will be interpreted as a
  121.      filename.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.